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i{{ TECHNICAL FIELD 

This invention relates to computer-implemented systems for managing 

3 imaging devices, such as digital cameras, scanners, and the like. This invention 

4 also relates to graphical window user interfaces, and particularly to user interfaces 
used to facilitate capture and storage management of digital images. • This 
invention fiirther relates to operating systems and browsers that incorporate image 

7 device managers and user interfaces. 
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9II BACKGROUND 

Digital imaging devices, such as scanners, cameras, video cameras, have 
nil been experiencing rapid growth in popularity as their price tags continue to 

12 decrease. Recreational photographers enjoy capturing pictures and videos and 

13 placing the digital files onto their computers for printing or emailing to friends and 

14 relatives. Businesses use scanners to digitally record documents used in day-to- 
15 II day operation for archival purposes. 

Other solutions to this problem already exist. For example, TWAIN and 
17 II ISIS are two image acquisition systems that are available today. However, both of 
18 these solutions have problems. TWAIN lacks robustness and interoperability. 
19 II ISIS is a proprietary design that renders it difficult to use with other applications. 

Accordingly, a task set before the inventor was to create an image 
21 II acquisition system that was based on an open architecture model and could be 

22 integrated with existing applications and operating systems to provide a 

23 convenient environment for the user. 
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SUMMARY 

This invention concerns an image acquisition system that offers an open 
architecture to integration with existing operating systems and other applications. 

In an exemplary implementation, the unage acquisition system is 
implemented on computer, such as a desktop personal computer, having a 
processing unit, memory, and operating system. One or more imaging devices are 
coupled to the computer. Examples of the imaging devices include a scanner, a 
digital camera, a digital video camera, and so forth. Some imaging devices, such 
as digital cameras, have a device memory and are capable of capturing a digital 
image and storing the image on its memory. Other imaging devices, such as 
scanners, may not have their own device memory. 

The image acquisition system further includes an image device manager 
tiiat is implemented in software on the computer to control operation of the 
imaging devices. The image acquisition system presents a user interface (UI) 
within the familiar graphical windowing environment. The UI presents a 
graphical window having a context space that pertains to a particular imaging 
context (e.g., scanning, photography, and video). In the camera context, the 
context space presents image files stored on the camera memory and/or on the 
computer memory. In the scanner context, the context space includes a preview 
scan area that reveals a preview of the image in the scanner. In the video context, 
the context space presents video clips stored on the computer memory, but 
logically represented as belonging to the video camera. 

The UI also has a persistently visible imaging menu positioned within the 
context space that lists options particular to an imaging context. For example, if 
the context space pertains to the camera context, the menu lists options to take a 
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picture, store a captured image, on the computer, send the image in an email, and 
so on. In the scanner context, the menu lists options to select an image type, 
preview an image, send the image to a particular destination, and scan the image. 

The image acquisition system also includes a set of application program 
mterfaces (APIs) that expose unage management functionality to applications. 
The APIs enable applications to manage loading and unloading of imaging 
devices, monitor device events, query device information properties, create device 
objects, capture images using the devices, and store or manipulate the images after 
their capture. 

BRIEF DESCRIPTION OF THE DRAWINGS 



Fig. 1 is a block diagram of an image acquisition system. 
Fig. 2 is a block diagram of a software architecture for the image 
acquisition system. 

Fig. 3 is a diagrammatic illustration of a graphical user interface window 
showing integration of the image acquisition system withm a famiUar file system 
settmg. 

Fig. 4 is a diagrammatic illustration of a graphical user interface window 
showing an opening window for managing unaging devices. 

Fig. 5 is a diagrammatic illustration of a graphical user mterface window 
for interfacing with a scanner. 

Fig. 6 is a diagrammatic illustration of a graphical user mterface window 

for mterfacing with a digital camera. 

Fig. 7 is a diagrammatic illustration of a graphical user interface window 
for interfacing with a digital video camera. 
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DETAILED DESCRIPTION 

This invention concerns a computer-implemented image acquisition system 
that manages imaging devices (such as digital cameras, scanners, digital video 
cameras, and the like) and the images captured by them. In a preferred 
implementation, the image acquisition system is implemented in a general-purpose 
computer (e.g., personal computer, laptop, etc.) to manage imaging devices 
attached locally to the computer or coupled remotely via a network. The image 
acquisition system supports a graphical user interface windowing environment that 
integrates image device management with the same look and feel of familiar 
browsing user interfaces for conventional file systems. In this manner, a user 
encounters a familiar experience when managing the imaging devices and image 
filds ficom his/her computer. 



Exemplary System Architecture 

Fig. 1 shows an image acquisition system 20 having a computer 22 coupled 
to multiple imaging devices 24-30. The computer 22 is a general-purpose 
computing device that is described and illustrated, for discussion purposes, as a 
desktop personal computer (PC). The computer 22 has a processing unit 40, a 
volatile irtemory 42 (e.g., RAM), a non-volatile data memory 44 (e.g., disk drive, 
etc.), a non-volatile program memory 94 (e.g., ROM, disk drive, CD-ROM, etc.), a 
display 48 (e.g., VGA monitor), and a universal serial bus (USB) 50. An 
operating system/browser 52 is stored in program memory 46 and executed on the 
processing unit 40 when the computer is booted. Examples of suitable operating 
systems 52 include the Windows-brand operating systems firom Microsoft 
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Corporation and the operating systems from Apple Computer. Although a USB 
50 is shown and described, other bus architectures may be used, including general 
serial buses, a SCSI bus, an IEEE 1394 serial bus that conforms to the IEEE 1394 
specification, and so forth. 

The imaging devices 24-30 are coupled to the computer via. a serial 
connection to the USB 50. Illustrated examples of the imaging devices include a 
scanner 24, a video camera 26, and a digital camera 28. However, other imaging 
devices (e.g., copiers, facsimile machines, etc.) may also be used in conjunction 
with aspects of this invention, as represented by the generic imaging device 30. 
Some of the imaging devices have their own memory, as represented by memory 
32 in imaging device 30. For example, the digital camera may have its own 
memory, whereas the scanner typically does not have a memory. 

The image acquisition system 20 includes an image device manager 60, 
which is implemented as a software componeiit loaded on the computer 22. More 
particularly, the image device manager 60 is stored in program memory 46 and 
runs on processing unit 40 during execution. The image device manager 60 may 
be integrated into the operating system 52 (as shown), executed as a set of 
services, or implemented as a separate self-contained program. 

The image acquisition system 20 also has a user interface 62, which is 
preferably a graphical user interface that presents a graphical window having a 
context space pertaming to the imaging context. Depending upon the particular 
context, the context space may list available imaging devices for which device 
drivers have been loaded onto the computer, or list digital image files captured by 
one or more of the imaging devices, or show an image bemg scanned in by the 
scaimer. 
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The user interface 62 further presents a persistently visible imaging menu 
positioned within the context space. The imaging menu lists options that are 
particular to controlling the various imaging devices. For instance, when the 
context space pertains to the camera context, the menu lists a "Take Picture" 
option that is specific to operatmg the digital camera 28. Upon user selection of 
"Take Picture", the image device manager 60 directs the digital camera 28 to 
record the current image obtained through the camera lens. In the scanner context, 
the menu lists a "Scan/Open" option that is particular to operating the scanner. 
Upon selection of this option, the image device manager 60 directs the scanner to 
scan the current image. 

The image device manager 60 has an image device driver 64 and a set of 
APIs (application program interfaces) 66. The image device driver 64 controls 
operation of the imaging device m response to selected options in the context- 
specific menu. The driver 64 is the code that facilitates communication with the 
imaging device over the USB 50 and passes commands to capture an image, to 
read image files fi:om the device's local memory, to obtain the device's properties, 
and so forth. 

The APIs 66 define a set of interfaces that can be used to access the 
functionality of the image device manager 60. These APIs are described below in 
a section entitled "Image Acquisition API". 

Exemplary Software Architecture 

Fig. 2 shows a software architecture 70 for implementing the image 
acquisition system. At the kernel level, the architecture 70 includes kernel I/O 
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drivers that include a bus driver to drive serial communication with the miaging 

device over the USB 50. 

At the user level, a device driver 74 is loaded for the particular imaging 
device connected to the computer. The device driver 74 includes a device object, 
an optional UI, and optional image processing capabilities. An image device 
manager object 76 is called to initialize and select an image device, and create the 
device interface. The image device manager object 76 performs such tasks as 
instantiating a device driver object 74, determining the device status, monitoring 
events from the device, and so forth. 

A COM (component object model) layer 78 exposes the device driver 
object 74 and image device manager object 76 to an upper level application 80. 
The application layer 80 represents both traditional TWAIN based applications 
that utilize a TWAIN compatibility layer 82, as well as new applications that 
support the APIs 66. Unlike the traditional TWAIN model, however, the TWAIN 
compatibility layer 82 interacts with the COM-based objects 74 and 76 rather than 
TWAIN-based devices. 

Image Acquisition User Interface 

The image acquisition system may be incorporated into the operating 
system, exist as a set of services, or be run as a separate, self-contained 
application. For discussion purposes, the image acquisition system is described as 
being integrated into an operating system that supports a graphical user interface 
windowing environment. 

Fig. 3 shows an initial graphical user interface window 100 presented on 
the computer display 48. This wmdow 100 is illustrated as the familiar "My 
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Computer" screen within a browser-based windowing setting, which is well 
known to users of Windows-brand operating systems. The "My Computer" 
window 100 presents a context for listing the major components that make up the 
user's PC, including disk drives, printers, a control panel, and networking 
functionality. 

Of interest to the image acquisition system is the integration and treatment 
of the imaging devices as a folder 102 organized with the other general computer 
components. This provides a convenient starting point for the user to access the 
imaging devices 24-30 that are coupled to the computer 22. 

When the user activates the "Imaging Devices" folder icon 102 for the first 
time, an installation Wizard comes up to guide the user through the installation of 
an imaging device. Suppose, for example, the user has installed two scanning 
devices arid a digital camera. Activating the "Imaging Devices" icon 102 navigates 
to a new "Imaging Devices" window. 

Fig. 4 shows the "Imaging Devices" window 110 presented on the 
computer display 48. The "Imagmg Devices" window 110 pertains to an imaging 
context and lists the imaging devices that have been installed on the computer. In 
this example, the window lists an "add imaging device" icon 112 and icons for the 
three installed devices: a "My Scanner" icon 114 for a locally installed scanner, a 
'•My Camera" icon 116 for the installed camera, and a "Jake's Scanner" icon 118 
for remotely installed (via a network connection) scanner. Activation of the "add 
imaging device" icon 112 recalls the wizard to enable the user to install any 
additional imaging devices. 

The "Imaging Devices" window 110 distinguishes between devices that are 
currently available and those that are not available (e.g., offline, physically 
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removed, etc.). Devices that are not available are dimmed and the user has the 
option of uninstalling them. In Fig. 4, the second scanner identified as "Jake's 
Scanner" is not available and hence the icon 11 8 is dimmed. 

Activating one of the imaging devices listed in window 110 causes the 
image acquisition system to present different windows exhibiting contexts that are 
specific to the selected imaging device. Within these device-oriented windows, 
the image acquisition system presents context-specific menus that contain items or 
options pertinent and relevant to the particular imaging device. 

Fig. 5 shows a "My Scanner" window 120 that is presented upon selection 
of the "My Scanner" icon 114 in Fig. 4. The scanner window 120 presents a 
context space 122 that pertains to the scannmg context. The context space 122 has 
a preview scan space 124 and a persistently-visible, context-specific menu 126 
positioned adjacent the preview scan space within the graphical window 120. 

The context-specific menu 126 is always visible in the scanner wmdow 
120. The menu 126 offers options that are tailored to operating the scanner 
attached to the computer or remotely coupled to the computer via a network. 
While some of the options may be included in a context menu (i.e., a menu that 
appears near the pointer following a right moue click), the persistently-visible 
menu 126 lists operating specific options tailored to the scanner that are not 
included elsewhere in the user mterface. 

The menu 126 includes an image type selection 128 that has a pull-down 
list of various image types from which a user may select. A non-exhaustive list of 
image types mcludes color photograph, black and white photograph, color Ime art, 
black and white line art, and text. The image types included in the pull-down list 
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128 are specific to the device. Some imaging devices may not provide support for 
a given format and hence the format is omitted in that particular list. 

A destination selection 130 has a pull-down list of various choices on what 
to do with the scanned image. For mstance, the list 130 might include using the 
image in an application, faxing the image, printing the image, copying the image 
to a clipboard, and saving the image in a file. The destination selection simplifies 
the output operation for the user. For example, selection of a choice directly 
affects the acquisition parameters and image quality without requiring the user to 
know what parameters to set. 

The persistently-visible context-specific menu 126 also has a "New 
Preview" command 132 that directs scanners to create a preview image of an 
image that is currently in the scanning bed. The image is presented in the preview 
scan space 124. When the image appears in the scan space 124, a preview control 
134 is provided to allow the user to select a region of the image for a fmal scan. In 
the illustrated implementation, the control 134 is shown as a dashed rectangular 
box framing the picture. The user can manipulate the box 134 to capture all or 
less than all of the image. Upon selection of the region, the control can 
proportionally resize the image to reflect the size of the scanner bed and 
automatically configure the scanner to make the appropriate adjustments to 
capture the selected image portion. 

The menu 126 includes a "Scan/Open" command 136 to direct the scanner 
to capture the image. When this command is selected, the scanner scans the image 
in its bed. Concurrently with this scannmg action, the image progressively 
appears in the preview scan space 124 to visually convey that the scanner is 



10 MS» n5S98 051001 JSS2 NEWPATAPPWlTHAPPENDIXMOyDOC 



r • 

scanning the image. In one implementation, the image is progressively displayed 
row-by-row from top to bottom of the image. 

The menu 126 includes a "Save" option 138, which directs the scanner to 
capture the image as a file and store tiie file in the computer memory. The last 
listed option is a "Send to" option 140, which allows the user to send the image to 
various locations (or applications) on the PC, such as for packaging in a facsimile 
or email. 

Fig. 6 shows a "My Camera" window 150 that is presented upon selection 
of the "My Camera" icon 116 in Fig. 4. The camera window 150 presents a 
context space 152 that pertains to the camera context. The context space 152 has a 
file space 154 and a persistently-visible, context-specific menu 156 positioned 
adjacent the file space within the graphical window 150. 

The context-specific menu 1 56 is always visible in the camera window 150 
and offers options that are tailored to operating the digital camera 28 attached to 
the computer. While some of the options may be included in a context menu (i.e., 
a menu that appears near the pointer following a right moue click), the 
persistently-visible menu 156 lists operating specific options tailored to the camera 
that are not included elsewhere in the user interface. 

The menu 156 is illustrated as haying two tabs: a pictures tab 158 and a 
camera tab 160. Table 1 contains the options and corresponding fimctions 
available on the pictures tab 158. 

Table 1 

Function 

Opens a picture with a default 



Option 



Open 
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registered application. 



Save in "My Pictures" folder Downloads the images from the 

camera and copies them to "My 
Pictures" directory on computer 
memory. 



Zoom 



Send to 



Lock on Camera 
Delete from Camera 

Rotate to the Right 
Rotate to the Left 
View Properties 



Changes the window view and allow 
the user to select one picture at the 
time and zoom in/out of the picture 
once it's copied locally. 

Allows the user to send the picture to 
various locations (or applications) on 
the PC. For example, the user may 
choose to "send" the picture to an 
"email recipient". 

Allows the user to lock a picture to 
prevent accidental deletion. 

Allows the user to permanently 
remove the picture from the camera 
after a confirmation. 

Allows the user to rotate the picture 90 
degrees to the right. 

Allows the user to rotate the picture 90 
degrees to the left. 

Allows the user to view properties 
associated with the selected picture(s). 



Table 2 contains the options and corresponding fimctions available on the 
camera tab 160. 



Option 
Take Picture 



Table 2 

Function 

Triggers the camera to take a picture. 
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Copy all Pictures 



Copies all the pictures to designated 
location on the PC. 



Remove all Pictures . 



Deletes all pictures in the camera. 



Share 



Brings up a wizard for the local user to 
share the camera. 



Initialize Memory Card 



Enables user to initialize the storage 
card in the camera. 



View Properties 



Allows the user to view a summary of 
the camera properties. 



The file space 154 lists files and/or folders that pertain to digital images 
taken by the digital camera. The files are the images themselves (e.g., JPG files) 
and the folders contain image files and/or other folders witii image files in them. 

The file space 154 presents the files that are currently stored on the camera. 
In this manner, the user can easily view the camera memory as if it were another 
memory of the computer. The UI allows easy integration of the camera control 
into the familiar windowing environment. 

To add a picture to the file space, the user captures a picture using the "Take 
Picture" command in the camera menu 160. The picture then appears as a file in 
the file space 154. The user can then select the image file by clicking on the file 
and manipulating the picture using the commands on the pictures menu 158, such 
as "Rotate to the Left", "Rotate to the Right", "Zoom", and "Send to". The user 
can also save the image file to the computer memory using the command "Save in 
My Pictures folder". 
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Fig. 7 shows a modified "My Camera" window 170 that supports dual- 
mode cameras (i.e., video and still). The modified window 170 is presented upon 
selection of the "My Camera" icon 116 in Fig. 4 and is similar to the window 150 
of Fig. 6 in that it has a context space 172 with a file space 174 and a persistently- 
visible, context-specific menu 176. However, in this modified implementation, 
the context-specific menu 176 also has a video tab 178 to list options pertaining to 
operation of the video camera 26. 

Notice also that one of the files in the file space 174 is a play-m-place video 
file 180. This play-m-place video file 180 can be actuated to play a video clip or 
stream within the small area depicted as box 180. That is, the static video icon in 
box 180 is replaced with a streaming video at the same location in the file space. 
Play-in-place video files 180 were first introduced in Media Manager, a 
multimedia application available from Microsoft. 

Table 3 contains the options and corresponding fimctions available on tiie 

video tab 178. 



Tables 



Option 

Play 
Open 

Capture Frame 
Capture Video 
View Properties 



Function 



Plays back a video stream from the 
video camera. 

Opens a video file with a default 
application. 

Directs the video camera to record a 
single still-image frame. 

Directs the video camera to record a 
video clip. 

Allows the user to view a summary of 
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the video camera properties. 

Other commands may be added to the menu. For instance, a "stop" 
command may be employed to halt the capture of live video. 

Image Acquisition API 

The image acquisition API 66 enables applications to manage loading and 
unloading of all imaging devices, monitor device events, query device information 
properties, create device objects, capture images using the devices, and store or 
manipulate the images after their capture. 

The interfaces are accessible by high level languages (e.g.. Visual Basic) as 
well as lower level ones (e.g., C, C-H-, etc.). COM is a suitable interface. In this 
context, each device is exposed as a COM object, whereby the object provides a 
number of methods and properties associated with the imaging device. 

As one exemplary implementation, there are three general objects: a device 
manager object, a camera object, and a scanner object. The objects are described 
generally below. A more detailed description of the objects and methods are 
provided at the end of this section. 

The device object contains device context and status information for a 
physical device. Once a device object is created for a physical device, the physical 
device controls what device properties are available and what values the properties 
may assume. There may be multiple device objects created for any physical 
device. However, a device object has exclusive access to a physical device before 
any operation (i.e., scan, take a picture, etc.) is performed. Exclusive access to a 
physical device is made available through a locking/unlocking mechanism. 
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The device manager is implemented as three objects that perform the 

following functions: 

A CImagelnDevMgr object is used to: 

• Create a device enumerator object 

• Create a device object when given a DevicelD 

• Display UI to let a user choose a device object 

• Display UI to both choose a device and acquire an image from the 
chosen device. 

A CEnumlmagelnDevInfo object is used to: 

• Enumerate all Imagein devices on a system. For each device 
enumerated, a CImagelnDevInfo object is returned. 

A CImagelnDevInfo object is used to: 

• Query device information properties from the Imagein device. One 
of the properties, Device ID, can be used by CImagelnDevMgr to 
create a device object. 

The camera object may expose the following functions: 

• Open and close the device for communication 

• Control the device 

• Update and read device properties 

• Update and read picture properties 

• Download, remove, and upload pictures to device 



La&Haya,PUX: 



16 



MS^ tiSm 05mU552NEWPATAPPmTHAPPEND!XM0i.DOC 



The scanner object may expose the following functions: 
Open and close the device for communication 

• Control the device 

• Update and read device properties 

• Set operation intent 

Imagein Device Manager 

The Imagein device manager provides interfaces for enumerating devices, 
querying properties of installed Imagein devices and creating Imagein device 
objects. The device manager has three objects. 

CImagelnDevMgr is used to: 

• Create an enumerator object, CEnumlmagelnDevInfo 

• Create a device object when given a DeviceDD. 

• Display UI to let a user choose a device object. 

• Display UI to both choose a device and acquire an image from the 
chosen device. 

CEnumlmagelnDevInfo is used to: 

• Enumerate all Imagein devices on a system. For each device 

enumerated, a CImagelnDevInfo object is returned. 

CImagelnDevInfo is used to: 

• Query device information properties from the Imagein device. One 
of the properties. Device ID, can be used by CImagelnDevMgr to 
create a device object. 
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Device information properties are distinct from normal device properties in 
that they are read from the registry and can be queried witiiout forcing the device 
object to be created. 

A program using its own methods to select an Imagein device would do the 

following: 

• Create a CImagelnDevMgr object 

• Use the IlmagelnDevMgr interface to create a 
CEnumlmagelnDevInfo object 

• Use ffinumIMAGEIN_DEV_INFO interface to create a 
CImagelnDevInfo object for each Imagein device enumerated. 

• Use IPropertyStorage interface of ClmagelnDevhifo object to 
inspect the device information properties of each device, save the 
Device ID property from the desired device. 

• Use the DevicelD property in IlmagelnDevMgr interface to create 
an Imagein device object. 

IlmagelnDevMgr Interface 
EnumlmagelnDevInfo 

HRESULT IlmagelnDevMgr: :EnumImageInDevlnfo( 
LONG IFlags, 
j IEnumIMAGEIN_DEV_INFO** ppIEnum) ; 

EnumlmagelnDevInfo creates a standard enumerator for CImagelnDevInfo 
objects. The enumerator itself is a CEnumlmagelnDevInfo object that has a single 
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interface ffiniimIMAGEIN_DEV_INFO. Applications can use this API to obtain 
device information properties from available Imagein devices. 

Parameters: 

IFlags Specifies the type of device to enumerate. 

ppIEnum Enumeration interface for CEnumlmagelnDevInfo objects. 

GetlmagelnDevInfo 

HRESULT IlmagelnDevMgr: : GetlmagelnDevInfo ( 

BSTR bstrDevicelD, 
IPropertyStorage** ppIPropStg) ; 

Given a device ID GetlmagelnDevInfo retums an IPropertyStorage 
interface to CImagelnElevInfo objects. This API gives applications a quick way to 
retrieve device information properties from a stored device ID. 

Parameters: 

bstrDevicelD, Device ID string retumed from device info object. 
ppIPropStg IPropertyStorage interface to CImagelnDevInfo objects. 

CreatelmagelnDev 

HRESULT IlmagelnDevMgr: : CreatelmagelnDev ( 

BSTR bstrDevicelD, 
lUnknown** ppDevice) ; 
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CreatelmagelnDev creates a device object identified by bstrDevicelD and 
returns an lUnknown interface to the object. The application can use 
Querylnterface on this lUnknown to access the other interfaces on a device. 

Parameters: 

bstrDevicelD Device ID string returned from device info object. 
ppDevice lUnknown interface pointer returned. 

SelectlmagelnDev 

HRESOLT IlmagelnDevMgr: : SelectlmagelnDev ( 
LONG IFiags, 
lUnknown** ppDevice); 

SelectlmagelnDev displays UI for the selection of Imagein devices. When 
the user selects a device, the device object is created and an lUnknown interface is 
returned. The application can then use Querylnterface on this lUnknown to access 
the other interfaces on a device. Returns S_FALSE if the user cancels the selection 
dialog without making a device selection, S_OK if the user makes a device 
selection or an error value if the method fails. 

Parameters: 

IFlags Operation flags 

ppDevice lUnknown interface pomter returned 

Getlmage 
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HRESULT IlmagelnDevMgr: :GetImage( 

LONG 1 Flags, 

LONG 1 Intent, 

LONG cf Format, 

STGMEDIUM* pMedium) ; 
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Getlmage displays device selection UI allowing a user to select a device. If 
the user selects a device, a device is created and device UI is displayed to capture 
the image. Image data is retumed in the pMedium structure. Image format and 
defauh image capture properties may be specified using the llntent and cfFormat 
parameters. Retums S^FALSE if the user cancels the selection dialog without 
making a device selection, S_OK if the user makes a device selection and the data 
is transferred or an error value if the method fails. 



Operation flags 

Intent, defauh image capture properties 
Clipboard format desired by application 
Image is retumed through this medium. 



Parameters: 

IFlags 

llntent 

cfFormat 

pMedium 

EnumDestinationlnfo 



HRESULT IlmagelnDevMgr: :EnumDestinationInfo ( 
LONG IFlags / 

lUnknown* pDevice, 
lEnumlMAGEIN DEBT INFO** ppIEnum) < 



EnumlmagelnDestlnfo creates a standard enumerator for 
CImagelnDestlnfo objects. The enumerator itself is a CEnumlmagelnDesflnfo 
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object that has a smgle interface lEnumlMAGEIN^DEST.INFO. Applications can 
use this API to obtain device destination properties from an Imagein device. 
Destination applications are registered using RegisterDestinationApplication. 



Parameters: 

IFlags Enumeration flags. 

pDevice Device object. If null destination applications for all devices 
are enumerated. 

ppIEnum Enumeration interface for CEnumlmagelnDestlnfo objects. 
RegisterDestinationApplication 

HRESULT. IlmagelnDevMgr: :RegisterDestinationApplication( 
LONG . - IFl.ags., 

LONG 1 Intent, 

lUnknown* ' pDevice, 

3STR bstrEvent, 
gSTR bstrAppName, 
ggijij^ bstrCoinmandLine) ; 

This method is called when an application wishes to register as an Imagein 
destination. 



Parameters: 
IFlags 
llntent 
pDevice 

bstrEvent 



Registration flags. 

Intent, defauU image capture properties. 
Device object. If null, destmation application is registered for 
all devices. 
Optional event name. 



bstrAppName Friendly name of Application. This name will be 
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displayed to the user in UI. 
bstrCommandLine Full path to the executable for this application. 

Additional command line arguments may be added to 
this command. 

UnregisterDestinationApplication 

HRESTUL IlmagelnDevMgr: :UnregisterDestinationApplication 
LONG 1 Flags, 

lUnknown* pDevice, 
BSTR bstrAppName) ; 

This method is called when an application that has registered an Imagein 
destmation wishes to be uninstalled or no longer known as Imagein destination 

Parameters: 

IFlags Operation flags. 

pDevice Device object. If null, destination application is 

unregistered for all devices. 
bstrAppName Friendly name of Application, used to register 

application. 

lEnumlMAGEIN DEV INFO Interface 

The lEnumlMAGEIN^DEV^INFO interface is a standard OLE 
enumeration interface that supports per device enumeration of device information 
properties. 
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Next 



HRESOLT IEnumIMAGEIN_DEV_INFO: :Next( 
ULONG celt, 
IPropertyStorage** rgelt, 
ULONG *pceltFetched) 



Next returns an array of IPropertyStorage interfaces to CImagelnDevInfo 
objects. Applications can use the returned of IPropertyStorage interfaces to obtain 
device information properties from available Imagein devices. 

Parameters: 

celt Specifies the number of elements requested, 

rgelt Address of an array in which to return the IPropertyStorage 

interfaces. 

pceltFetched Address of a value that receives a count of the item identifiers 
actually retumed in rgelt. 



Skip 

HRESOLT IEnumIMAGEIN_DEV_INFO: : Skip (ULONG celt) ; 

Skip skips device objects in the enumeration. 
Parameters: 

celt Number of items to skip. 

Reset 
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HRESULT IEnumIMAGEIN_DEV_INFO: : Reset (void) ; 

Reset sets the enumeration back to the first device. 
Clone 

HRESULT IEnumIMAGEIN_DEV_INFO: : Clone { 

IEnumIMAGEIN_DEV_INFO **ppIEnuin); 

Clone creates another IEnuniIMAGEIN_DEV_^INFO enumeration object 
and returns an interface pointer to it. 

Parameters: 

ppIEnum Address that receives a pointer to the new enumeration 
object. 

TEnumlMAGEIN DKST TNFQ Interface 

The IEnumIMAGEINJDEST_INFO interface is a standard OLE 
enumeration interface that supports enumeration of device destination properties. 

Next 

HRESULT IEnumIMAGEIN_DEST_INFO: :Next { 
ULONG celt, 
I PropertyStorage* * rgelt , 
ULONG *pceltFetched) ; 
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Next returns an array of IPropertyStorage interfaces to CImagelnDestlnfo 
objects. Applications can use the returned of IPropertyStorage interfaces to obtain 
destination information properties from available Imagein devices. 

Parameters: 

celt Specifies the number of elements requested, 

rgelt Address of an anray in which to return the IPropertyStorage 

interfaces. 

pceltFetched Address of a value that receives a count of the item identifiers 
actually retumed in rgelt. 

Skip 

HRESULT IEniamIMAGEIN_DEST_INFO: :Skip(ULONG celt); 

Skip skips destination objects in the enumeration. 
Parameters: 

celt Number of items to skip. 

Reset 

HRESULT IEnumIMAGEIN_DEST_INFO::Reset(void); 

Reset sets the enumeration back to the furst device. 
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Clone 



HRESULT IEnuinIMAGEIN_DEST_INFO : : Clone { 

IEnumIMAGEIN_DEST_INFO **ppIEnum) ; 



Clone creates another IEnumIMAGEIN_DEST_INFO enumeration object 
and returns an interface pointer to it. 



Parameters: 

ppIEnum Address that receives a pointer to the new enumeration 
object 



IPropertvStoraee Interface 

The IProperty Storage interface is used to query the device information and 
destination properties. IPropertyStorage is a standard OLE mterface and is 
documented in the OLE Programmers Reference. All device information 
properties are read only. Any attempt to modify the device mformation properties 
will result in a failure with access denied. The methods of this mterface are: 



HRESULT ReadMultiple(ULONG, const PROPSPEC, PROPVARIANT) ; 

HRESULT WriteMultiple(ULONG, const PROPSPEC, PROPVARIANT, 
PROPID) ; 

HRESULT DeleteMultiple{ULONG, const PROPSPEC) ; 

HRESULT ReadPropertyNames(ULONG, const PROPID, LPOLESTR) ; 

HRESULT WritePropertyNames(ULONG, const PROPID, LPOLESTR); 

HRESULT DeletePropertyNames(ULONG, const PROPID); 

HRESULT Commit { DWORD) ; 

HRESULT Revert (void) ; 

HRESULT EnumdEnumSTATPROPSTG** ) ; 

HRESULT Set Times {FILETIME const *, FILETIME const *, FILETIME 
const * ) ; 

HRESULT SetClass(REFCLSID); 

HRESULT Stat(STATPROPSETSTG *); 
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Device Infoimation Properties 

All Imagein devices support the following basic device information 
properties: . 

Device CLSID - The CLSID of the Imagein server for this device. 
Unique Device ID - A device ID which is unique per physical device. 
Vendor Description - The device manufactures name. 
Device Description - A description of the device. 
Device Type - A device type constant: scanner, camera. . . 

Device Port Name - Name of the port through which the device is 

coimected. 

Device Friendly Name - A user readable device name. 
Device Icon Resource - Resource file name and ID. 
Device Bitmap Resource - Resource file name and ID. 
Server Name - The name of the server where the Imagein server for 

this device is running. 

Imagein Scanner Device Object 

Imagein device objects support interfaces for querying and setting device 
properties, displaying device XJI and transferring data. Imagein devices are 
requu-ed to support a small number of standard interfaces that allow applications 
to deal with all devices in a common manner and transfer data from the devices in 
a manner that is native to the (COM) application. Device objects may also support 
more specialized interfaces to implement custom functions. Since the application 
has a direct connection to the device object, this architecture does not place any 
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strict limits on the interfaces a device object can export. Practically speaking 
though, applications must know about an interface for it to be useful. 



IScari Interface 
ScanDlg 



HRESULT ScanDlg ( 

LONG 1 Flags, 

LONG llntent) ; 



ScanDlg presents the system or device UI needed to prepare a device for 
scanning. If the dialog successfully completes, the scan object will be ready to 
begin data transfer via the IDataObject or limageTransfer interfaces. The default 
image capture properties may be specified using the optional llntent parameter. 
Returns S_FALSE if the user cancels the selection dialog without making a device 
selection, S_OK if the user makes a device selection or an error value if the 
method fails. 

Parameters: 

IFlags Operation flags 

llntent Intent, default image capture properties 

IPropertvStorage Interface 

The standard IPropertyStorage interface is used to query and set all scan 
device properties. IPropertyStorage is a standard OLE interface and is documented 
in the OLE Programmers Reference. The methods of this interface are: 
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HRESULT ReadMultiple(ULONG, const PROPSPEC, PROPVARIANT) ; 

HRESULT WriteMultiple(ULONG, const PROPSPEC, PROPVARIANT, 
PROPID) ; 

HRESULT DeleteMultiple(ULONG, const PROPSPEC) ; 

HRESULT ReadPropertyNames{ULONG, const PROPID, LPOLESTR) ; 

HRESULT WritePropertyNaines(ULONG, const PROPID, LPOLESTR); 

HRESULT DeletePropertyNames{ULONG, const PROPID); 

HRESULT Commit ( DWORD) ; 

HRESULT Revert (void) ; 

HRESULT EnumdEnumSTATPROPSTG**) ; 

HRESULT SetTimes(FILETIME const *, FILETIME const *, FILETIME 
const * ) ; 

HRESULT SetClass(REFCLSID); 

HRESULT Stat (STATPROPSETSTG *); 



All Imagein scanner devices support the foUowmg basic device properties: 

Horizontal Resolution - The horizontal resolution in DPI. 
Vertical Resolution - The vertical resolution in DPI. 
Horizontal Scan Start Position - The horizontal start position in pixels. 
Vertical Scan Start Position - The vertical start position in pixels. 
Horizontal Scan Extent - The width of the scan in pixels. 
Vertical Scan Extent - The height of the scan in pixels. 
Scan Data Type - A data format specification constant. 

Scan Color Depth - The number of bits per pixel used to specify 

color. 

Imagein scan devices may support additional device properties depending 
on hardware configuration. 

IDevPropStream Interface 
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The IDevPropStream interface is used to query/set all current device 
properties from/to a named, non-volatile, registry based storage. The methods of 
this interface are: 

ReadDevPropStream 

HRESULT ReadDevPropStream (BSTR bstrName) ; 



6 
7 
8 
9 
10 
11 
12 
13 
14 
IS 
16 

pll HRESULT WriteDevPropStream(BSTR bstrName); 



ReadDevPropStream reads a device property stream from the specified 
value and initializes the device with these properties. The properties are per user 
and per device. 

Parameters: 

bstrName Name of the property stream. 

WriteDevPropStream 
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WriteDevPropStream writes the current device property stream to the 
specified value. The properties are per user and per device. 

Parameters: 

bstrName Name of the property stream. 

ListDevPropStreams 
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HRESULT ListDevPropStreams(BSTR *pbstrName); 

ListDevPropStreams lists the device property stream names present in non- 
volatile storage. The list is returned in an allocated BSTR which the application 
must free using SysFreeString. 



Parameters: 
pbstrName 



Pointer to receive a list property streams. 



DeleteDevPropStream 



HRESULT DeleteDevPropStream (BSTR bstrName); 



DeleteDevPropStream deletes a device property stream from non-volatile 



storage. 



Parameters: 
bstrName 



Name of the property stream. 



22 
23 
24 
25 



TDataObiect Interface 

The IDataObject interface is a standard OLE data transfer mechanism. This 
interface is used to provide an easy and natural way for applications to transfer 
data from a scan device. The full IDataObject interface description can be found in 
the 0LE2 Programmer's Reference. The methods of this interface are: 



32 MS^ U$m 0510011552 SEnTATAPPmmAPPENDlXM03.DOC 



HRESULT GetData(LPFORMATETC, LPSTGMEDIUM) ; 

HRESULT GetDataHere(LPFORMATETC, LPSTGMEDIUM); 

HRESULT QueryGetData(LPFORMATETC) ; 

HRESULT • GetCanonicalFormatEtc(LPFORMATETC,LPFORMATETC) ; 

HRESULT Set Data (LPFORMATETC, STGMEDIUM FAR *, BOOL) ; 

HRESULT EnumFormatEtcC DWORD, LPENUMFORMATETC FAR *); 

HRESULT DAdvise(FORMATETC FAR *, DWORD, LPADVISESINK, DWORD 
FAR *) ; 

HRESULT DUnadvise (DWORD) ; 

HRESULT EnumDAdvise (LPENUMSTATDATA FAR *); 



TTmageTransfer Interface 

The IlmageTransfer is a high performance data transfer interface. This 
interface uses a shared memory window to transfer data from the device object to 
the application, eliminating unnecessary data copies during marshalling. For 
Simplicity, this interface uses the same format negotiation method as IDataObject. 
IlmageTransfer uses two different mechanisms to transfer data.: 

Banded TVansfers 

The device breaks a large image transfer up into smaller transfers, which 
are performed sequentially into an application-specified buffer. 

Data Callback 

The device does a single large transfer, while calling back to the application 
as the transfer progresses. 

itAllocateTVansferBuffer 

HRESULT itAllocateTransf erBuf f er ( 
LONG IFlags, 
LONG ISize, 
ULONG hSection, 
ULONG ProcessID) ; 
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Allocates a buffer to use for scanning data from the device. The buffer is 
mapped into the address space of both the client and server process. 

Parameters: 



itFreeTransferBuffer 

HRESULT . itFreeTransf erBuf f er (void) ; 

Free the buffer created by itAUocateTransferBufifer. This buffer is also freed 
when the device object is destroyed. 

ItBeginTransfer 

HRESULT itBeginTransfer( 



hSection 



IFlags 



ISize 



ProcessID 



Operation flags. 

Size in bytes of the requested buffer. 
Mapped section handle 
Caller process ID 



LPFORMATETC 
LONG 

IDataCallback* 



pFormatEtc, 
IFlags, 

pIDataCallback) ; 



Reset a device object context to begin an IlmageTransfer. 



Parameters: 



pFormatEtc 



Format specification. 
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IFlags Operation flags. 

pIDataGallback Optional transfer progress notification entry point. 
ItGetlmage 

HRESULT itGetImage{ 

LONG IFlags, 

LONG* pi SrcOf f set , 

LONG* pcbWritten) ; 

Perform an image transfer. 
Parameters: 

IFlags Operation flags. 

plSrcOfifset Source pointer for transfer. 

pcbWritten Actual number of bytes written during transfer. 

itGetlmageCB 

HRESULT ItGetlmageCB (LONG IFlags); 

Perform an image transfer using a user specified callback. 
Parameters: 

IFlags Operation flags. 

itEndTransfer 
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HRESULT itEndTransfer (LONG IFlags) ; 

Cleanup a device object context after an image transfer. 
Parameters: 

IFiags Operation flags. 

ItQueryGetData 

HRESULT ItQueryGetData (LPFORMATETC 'pf e) ; 

Check to see if a device supports a given format in an image transfer. 
Parameters: 

pfe Pointer to the FORMATETC structure defining the format, 

medium, and target device to use for the query. 

ItEnumFormatEtc 

HRESULT itEnumFormatEtc ( 
DWORD 

LPENUMFORMATETC* 

Create a format enumerator. 

Parameters: 
dw Reserved 

IpEnum Indirect pomter to the lEnumFORMATETC interface 



dw, 

IpEnum) ; 
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on the new enumerator object. 
Imagein Camera Device Obiect 

The Imagein Camera is a hierarchical object. The top-level camera object is 
used to get basic device information and also to get access to individual images or 
image folders. The CCameraltem object represents images and Image folders, 

ICamera Interface . 
TakePicture 

HEIESOLT TakePicture ( ) ; 

The TakePicture method instructs a camera to take a new picture. 
GetCameraRootltem 

HRESULT GetCameraRootltem (ICameraltem** pICameraltem) ; 

This method returns an interface to the root CCameraltem object. Using the 
Icameraltem interface it is possible to enumerate all images on the camera. 

Parameters: 

PICameraltem Interface pomter to root camera item 
GetCameraltemByHandle 
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HRESULT GetCameraltemByHandle ( 

ULONG ulItemHandle, 
ICameraltem** pICameraltem) 
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This method returns an ICameraltem interface to the specified 
CCameraltem object. A handle for a CCameraltem object can only be obtained 
through the ICameraltem interface. 



Parameters: 
ulItemHandle 

pICameraltem 

CameraDIg 



HRESULT CameraDIg ( 
LONG 
LONG 

ICameraltem** 



Handle to camera item, previously retumed by 
Cameraltem interface 

Interface pointer to Camera Item specified by handle 



IFlags, 
llntent/ 
pICameraltem) ; 



Display the camera UI. UI will select an image on a device and prepare for 
image transfer. The UI retums a ICameraltem interface to a CCameraltem ready 
for data transfer. IDataObject or IlmageTransfer interfaces are then used to transfer 
iniagedata. 



Parameters: 

IFlags 

llntent 

pICameraltem 



Operational flags 
High level intent 

Interface pointer to Camera Item selected by Dig 
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ICameraltem Interface 

A CCameraltem object is created for every image and directory on the 
camera. This is done to support full and flexible hierarchical image storage on 
cameras. A ICameraltem pointer is retumed for each CCameraltem object, 
ICameraltem methods are defined below. 

Getltemiype 

HRESULT GetItemType(ULONG *pItemType) ; 

GetltemType returns the type of camera item the object represents. The two 
types of camera items are: 

1. ItemTypeFolder - CCameraltem is a folder that may contain other 

CCameraltems 

2. ItemTypelmage - Ccameraltem is an image. 

Parameters: 

pItemType Item Type retumed 
GetltemHandle 

HEIESULT GetltemHandle (ULONG *pItemHandle) ; 

Returns a handle to the CCameraltem. This handle can later be used by the 
ICamera interface to get an interface pointer back to this object. 
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2 Parameters: 

PItemHandleltem handle returned. This handle may be used by the 
GetCameraltemByHandle method of the ICamera interface to obtain an 
Icameraltem pointer. 



OpenlmagePropertyStorage 



HRESULT OpenlmagePropertyStorage (IPropertyStorage** 
ppIPropertyStorage) ; 



Returns an IPropertyStorage interface to the CCameraltem object. 
Parameters: 

ppIPropertyStorage Retumed IPropertyStorage mterface pointer. 

EnumChildltems 

HRESULT En\imChilciItems{IEnumCameraItem** ppIEnumCameraltem) ; 

Creates a CEnumCameraltem object and retums a lEnumCameraltem 
interface to it. This method only works if the camera item is a folder and the folder 
is not empty, as shown in the figure above. 

Parameters: 

ppIEnumCameraltem Pointer to iEnumCameraltem interface. 
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lEnumCameraltem Interface 

lEnumCameraltem is a standard OLE enumerator interface with the usual 
four methods Next, Skip, Clone and Reset. This enumerator will return an 
ICameralnterface for each camera item in the current camera folder (that was oised 
in the call to EnumChildltems). 

Next 

HRESULT Next ( 



Return an ICameraltem interface for each CCameraltem contamed by . the 
current folder. 

Parameters: 



ULONG 

ICameraltem** 
ULONG* 



celt, 

ppICameraltem, 
pceltFetched) ; 



ceh 



number of camera items to get 



ppICameraltem 
pceltFetched 



List of iCameraltem interface pointers returned. 
Number of interface pointers returned 



Skip 



HRESULT Skip (ULONG celt); 



Skip celt CCameraltem objects. 
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Parameters: 

celt Number of Ccameraltem objects to skip 

Reset 

HRESULT Reset (void) ; 

Begin at the first CCameraltem object. 

Parameters: None 

Clone 

HRESULT Clone (lEniimCameral tern **ppIEnumCameraItem ); 

Create a new CEnumCameraltem object and retum a lEnumCameraltem 
interface. 

Parameters: 

ppIEnumCameraltem New enumerator created to exactly match this 

one. 
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Camera Download Manager 

The camera download manager monitors the connection status of camera 
devices. When a camera device is connected to the system, the Download 
Manager will attempt to immediately download all the unages from the camera 
onto the system hard disk. The camera download manager will also maintain a 
data base of all unages previously downloaded from a given camera and not 
download images that are aheady cached. 

Cachmg images in this manner has several advantages. 

• Camera image download can be very slow, this cache prevents any 
image from needing to be downloaded more than once. 

• Applications, do not need a special API to acquire images from a 
camera, simply wait for the download to complete and load the image 
from the file system. 

• Images are safely and automatically copied to the file system where they 
can easily be edited, archived, printed or just saved. 

In order for the camera download manager to work effectively, camera 
events must be detectable. For example, it should be easy to detect when a camera 
is connected or disconnected from the system. This should be detectable without 
loading the entire camera driver. Also any activity performed directly on the 
camera (through camera controls) must be reported to software so an accurate 
internal model of the state of the camera can be kept. 
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Sample Code 

Get an image from an Imagein device. Use the Imagein device manager 
device selection UI and the device image acquisition UI. 
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/******************************************************************** *********** 
* 

* GetlmageFromlmageln 
* 

* DESCRIPTION: 

* Use the Imagein device manager to select a device and acquire an 

* image using the device UI. 
♦ 

* PARAMETERS : 

* pszDIBfileName - Name of the DIB file which contain the image data. 
* 

*******************************************************************************/ 
HRESULT GetlmageFromlmageln (LPOLESTR pszDIBfileName) 



HRESULT 

IlmagelnDevMgr 



hr; 

♦pIImagelnDevMgr; 



// Get Imagein device manager object, 
hr e CoCreateInstance(CLSID_lmageInDevMgr, 
NULL, 

CLSCTX_LOCAL_$ERVER, 
1 1 D_I Image InDe vMgr , 
(void**)&pIImageInDevMgr) ;/ 

if (SUCCEEDED (hr) ) { 
STGMEDIUM StgMedium; 

// Fill in the storage medium spec and get the image. 
StgMedium. tymed = TYMED_FILE; 
StgMedium. IpszFileName = pszDIBfileName; 
StgMedium. pUnkForRelease = NULL; 
hr » pllmageInDevMgr->GetImage(0, 

CF_DIB, 
&StgMedium) ; 

pIImageInDeTrtlgr->Release 0 ; 

) 

return hr; 
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Enumerate all installed Imagein devices and get the device ID of a specific 



device: 



/******************************************************************************* 

* . 

* GetDevicelDfromDescription 
♦ 

* DESCRIPTION: 

* Get the unique device ID of an Imagein device based on it's description, 
♦ 

* PARAMETERS: ; 

* pszDescription - Requested device description^ from device info properties. 

* pszDevicelD - Buffer for the returned device ID. 

* cbDevicelDSize - Size of the returned device ID buffer in bytes. 
♦ 

*******************************************************************************/ 

HRESULT GetDevicelDfromDescription ( 
LPOLESTR pszDescription, 
LPOLESTR pszDevicelD, 
UINT cchDevicelD) 

{ 

HRESULT hr; 
IlmagelnDevMgr *pHmageInDevMgr; 

if (pszDevicelD && cchDevicelD) { 
♦pszDevicelD = '\0'; 

} 

else ( 

return. E INVALIDARG; 
) " 

// Get Imagein device manager object, 
hr » CoCreateInstance(CLSID_ImageInDevMgr, 
NULL, 

CLSCTX_LOCAL_SERVER, 
I I D_I Image I nDe vMgr , 
(void**) &pIImageInDevMgr) ; 

if (SUCCEEDED (hr) ) { 

IEnumIMAGEIN_DEV_INFO *pIEnumIMAGEIN_DEV_INFO; 
PROPSPEC PropSpec[l) ; 
PROPVARIANT PropVarDesc (1] , PropVarID[13; 
UINT cbSize; 

// Get an enumerator for the Imagein device information. 

hr = piimageInDevMgr->EnumImageInDevInfo(0, &pIEnumIMAGEIN_DEV_INFO) ; 

if ( SUCCEEDED (hr)) { 

IPropertyStorage *pIPropStg; 

DLONG ul; 

// Enumerate the Imagein devices, getting a IlmagelnDevInfo . 
//. pointer for each. Use this interface to query the registry 
// based properties for each installed device, 
ul = 1; 

while ((hr = pIEnumIMAGEIN_DEV_INFO->Next { 1 , 

fipIPropStg, 
&ul)) == S_OK) { 

// Read the device description for the current device. 
PropSpec[0) .ulKind = PRSPEC_PROPID; 
PropSpecio] .propid « DIP DEV_DESC; 

hr « pi Props tg->ReadMultIple(l, PropSpec, PropVarDesc); 
if ( SUCCEEDED (hr)) { 

// Test for a description match. 

if ( I wcscmp (PropVarDesc (0) .pwszVal, pszDescription)) { 
// Read the device ID. 



45 MS* asm 0510011552 NEWPATAPPWnHAPPESDlXM03.DOC 



PropSpec[0) .propid = DIP_DEV_ID; 

hr = plPropStg->ReaclMultIple(l, PropSpec^ PropVarlD); 
if (SUCCEEDED (hr)) ( 

wcsncpy(pszDeviceID, PropVarlD [01 .pwszVal, cchDevicelD) ; 

PropVariantClear (PropVarlD) ; 

) 

) 

PropVariantClear (PropVarDesc) ; 

pIPr6pStg->Release ( ) ; * 
if (*ps2DeviceID) { 
break; 

> 

} 

pIEnuinIMAGEIN_DEV_lNFO->Release() ; 

} 

pIIinageInDevMgr->Release ( ) ; 
if ( !*pszDeviceID) { 
hr = E_FAIL; 

) 

} 

return hr; 
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Although the invention has heen described in language specific to structural 
features and/or methodological steps, it is to be understood that the invention 
defined in the appended clauns is not necessarily limited to the specific features or 
steps described. Rather, the specific features and steps are disclosed as preferred 
forms of implementing the claimed invention. 
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